﻿<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="../helpproject.xsl" ?>
<topic template="Default" lasteditedby="Geert" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../helpproject.xsd">
  <title translate="true">TraceOutputControl</title>
  <keywords>
    <keyword translate="true">Log</keyword>
    <keyword translate="true">Logging</keyword>
    <keyword translate="true">Output</keyword>
    <keyword translate="true">Trace</keyword>
    <keyword translate="true">TraceOutputControl</keyword>
  </keywords>
  <body>
    <header>
      <para styleclass="Heading1"><text styleclass="Heading1" translate="true">TraceOutputControl</text></para>
    </header>
    <para styleclass="Normal"><link displaytype="text" defaultstyle="true" type="topiclink" href="T_Catel_Windows_Controls_TraceOutputControl" styleclass="Normal" translate="true">TraceOutputControl</link><text styleclass="Normal" translate="true"> is a debugging convenience control. It shows all the trace and logging output in a filterable control. This way, you can easily view all the binding errors, etc., in your app instead of the non-colored output window in Visual Studio.</text></para>
    <para styleclass="Normal"><image src="traceoutputcontrol.png" scale="100.00%" styleclass="Image Caption"></image></para>
    <para styleclass="Code Example"><text styleclass="Code Example" style="font-weight:normal; font-style:normal; text-decoration:none; color:#000000;" translate="true">&lt;Controls:TraceOutputControl</text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; text-decoration:none; color:#ffffff;" translate="true"> </text><text styleclass="Code Example" style="font-weight:normal; font-style:normal; text-decoration:none; color:#000000;" translate="true">/&gt;</text></para>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">Many times, developers are inside an application viewing the result of what they have created. But, they also want to know what is happening in the background and view the traces they have written. The output window of Visual Studio is a solution, but it doesn’t show errors very well (black, just as the normal output). Also, it doesn’t allow run-time filtering of the results.</text></para>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">The </text><link displaytype="text" defaultstyle="true" type="topiclink" href="T_Catel_Windows_Controls_TraceOutputControl" styleclass="Normal" translate="true">TraceOutputControl</link><text styleclass="Normal" translate="true"> allows a developer to embed a control inside a window or control in the actual application and view the information when the application is actually running. The </text><link displaytype="text" defaultstyle="true" type="topiclink" href="T_Catel_Windows_Controls_TraceOutputControl" styleclass="Normal" translate="true">TraceOutputControl</link><text styleclass="Normal" translate="true"> is also available as a separate window in case it can’t be embedded into the software itself (for example, when a plug-in is being developed for a 3rd party application).</text></para>
    <para styleclass="Normal"><text styleclass="Normal" translate="true">The </text><link displaytype="text" defaultstyle="true" type="topiclink" href="T_Catel_Windows_Controls_TraceOutputControl" styleclass="Normal" translate="true">TraceOutputControl</link><text styleclass="Normal" translate="true"> subscribes a custom </text><text styleclass="Normal" style="font-style:italic;" translate="true">TraceListener</text><text styleclass="Normal" translate="true"> to the </text><text styleclass="Normal" style="font-style:italic;" translate="true">Trace.Listeners</text><text styleclass="Normal" translate="true"> collection. Then, it filters out the messages that the user actually wants to see and stores these messages into an internal collection so the user can still filter the messages at a later time.</text></para>
  </body>
</topic>
